package com.xiaozhi.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.xiaozhi.entity.Notification;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 通知服务接口
 * 定义通知系统的业务逻辑方法
 */
public interface NotificationService {

    /**
     * 创建通知
     * @param notification 通知对象
     * @return 创建的通知
     */
    Notification createNotification(Notification notification);

    /**
     * 创建系统通知
     * @param userId 用户ID
     * @param title 标题
     * @param content 内容
     * @param priority 优先级
     * @return 创建的通知
     */
    Notification createSystemNotification(Long userId, String title, String content, String priority);

    /**
     * 创建预约通知
     * @param userId 用户ID
     * @param appointmentId 预约ID
     * @param title 标题
     * @param content 内容
     * @param scheduledAt 计划发送时间
     * @return 创建的通知
     */
    Notification createAppointmentNotification(Long userId, Long appointmentId, String title, String content, LocalDateTime scheduledAt);

    /**
     * 创建健康提醒通知
     * @param userId 用户ID
     * @param healthRecordId 健康记录ID
     * @param title 标题
     * @param content 内容
     * @param priority 优先级
     * @return 创建的通知
     */
    Notification createHealthReminderNotification(Long userId, Long healthRecordId, String title, String content, String priority);

    /**
     * 创建分析报告通知
     * @param userId 用户ID
     * @param analysisId 分析ID
     * @param title 标题
     * @param content 内容
     * @return 创建的通知
     */
    Notification createAnalysisNotification(Long userId, Long analysisId, String title, String content);

    /**
     * 创建症状评估通知
     * @param userId 用户ID
     * @param assessmentId 评估ID
     * @param title 标题
     * @param content 内容
     * @param priority 优先级
     * @return 创建的通知
     */
    Notification createSymptomAssessmentNotification(Long userId, Long assessmentId, String title, String content, String priority);

    /**
     * 批量创建通知
     * @param notifications 通知列表
     * @return 创建成功的数量
     */
    Integer batchCreateNotifications(List<Notification> notifications);

    /**
     * 分页查询用户通知
     * @param page 分页参数
     * @param userId 用户ID
     * @param type 通知类型
     * @param status 通知状态
     * @param priority 优先级
     * @param isRead 是否已读
     * @return 分页通知列表
     */
    IPage<Notification> getUserNotifications(Page<Notification> page, Long userId, String type, String status, String priority, Boolean isRead);

    /**
     * 获取用户最近通知
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 最近通知列表
     */
    List<Notification> getRecentNotifications(Long userId, Integer limit);

    /**
     * 获取用户未读通知数量
     * @param userId 用户ID
     * @return 未读通知数量
     */
    Integer getUnreadNotificationCount(Long userId);

    /**
     * 获取用户未读通知数量（按类型分组）
     * @param userId 用户ID
     * @return 按类型分组的未读通知数量
     */
    Map<String, Integer> getUnreadNotificationCountByType(Long userId);

    /**
     * 获取高优先级未读通知
     * @param userId 用户ID
     * @return 高优先级未读通知列表
     */
    List<Notification> getHighPriorityUnreadNotifications(Long userId);

    /**
     * 标记通知为已读
     * @param userId 用户ID
     * @param notificationId 通知ID
     * @return 是否成功
     */
    Boolean markAsRead(Long userId, Long notificationId);

    /**
     * 批量标记通知为已读
     * @param userId 用户ID
     * @param notificationIds 通知ID列表
     * @return 更新的记录数
     */
    Integer batchMarkAsRead(Long userId, List<Long> notificationIds);

    /**
     * 标记所有通知为已读
     * @param userId 用户ID
     * @param type 通知类型（可选）
     * @return 更新的记录数
     */
    Integer markAllAsRead(Long userId, String type);

    /**
     * 删除通知
     * @param userId 用户ID
     * @param notificationId 通知ID
     * @return 是否成功
     */
    Boolean deleteNotification(Long userId, Long notificationId);

    /**
     * 批量删除通知
     * @param userId 用户ID
     * @param notificationIds 通知ID列表
     * @return 删除的记录数
     */
    Integer batchDeleteNotifications(Long userId, List<Long> notificationIds);

    /**
     * 发送通知
     * @param notificationId 通知ID
     * @return 是否成功
     */
    Boolean sendNotification(Long notificationId);

    /**
     * 批量发送待发送通知
     * @param limit 限制数量
     * @return 发送成功的数量
     */
    Integer processPendingNotifications(Integer limit);

    /**
     * 重试失败的通知
     * @param limit 限制数量
     * @return 重试的数量
     */
    Integer retryFailedNotifications(Integer limit);

    /**
     * 获取通知详情
     * @param userId 用户ID
     * @param notificationId 通知ID
     * @return 通知详情
     */
    Notification getNotificationDetail(Long userId, Long notificationId);

    /**
     * 获取通知统计信息
     * @param userId 用户ID（可选）
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计信息
     */
    Map<String, Object> getNotificationStatistics(Long userId, LocalDateTime startTime, LocalDateTime endTime);

    /**
     * 获取用户通知偏好
     * @param userId 用户ID
     * @return 通知偏好统计
     */
    List<Map<String, Object>> getUserNotificationPreferences(Long userId);

    /**
     * 清理过期通知
     * @return 清理的记录数
     */
    Integer cleanupExpiredNotifications();

    /**
     * 创建定时提醒
     * @param userId 用户ID
     * @param title 标题
     * @param content 内容
     * @param scheduledAt 计划发送时间
     * @param repeatType 重复类型（ONCE, DAILY, WEEKLY, MONTHLY）
     * @return 创建的通知
     */
    Notification createScheduledReminder(Long userId, String title, String content, LocalDateTime scheduledAt, String repeatType);

    /**
     * 取消定时提醒
     * @param userId 用户ID
     * @param notificationId 通知ID
     * @return 是否成功
     */
    Boolean cancelScheduledReminder(Long userId, Long notificationId);

    /**
     * 更新通知设置
     * @param userId 用户ID
     * @param settings 通知设置
     * @return 是否成功
     */
    Boolean updateNotificationSettings(Long userId, Map<String, Object> settings);

    /**
     * 获取通知设置
     * @param userId 用户ID
     * @return 通知设置
     */
    Map<String, Object> getNotificationSettings(Long userId);

    /**
     * 推送实时通知
     * @param userId 用户ID
     * @param notification 通知对象
     * @return 是否成功
     */
    Boolean pushRealTimeNotification(Long userId, Notification notification);

    /**
     * 创建紧急通知
     * @param userId 用户ID
     * @param title 标题
     * @param content 内容
     * @param actionUrl 操作链接
     * @return 创建的通知
     */
    Notification createEmergencyNotification(Long userId, String title, String content, String actionUrl);

    /**
     * 广播系统通知
     * @param title 标题
     * @param content 内容
     * @param targetUserIds 目标用户ID列表（为空时广播给所有用户）
     * @return 创建的通知数量
     */
    Integer broadcastSystemNotification(String title, String content, List<Long> targetUserIds);
}